RegisterCallback

註冊一個當新數據進入時 KINGSTAR 子系統將呼叫的函式。

語法

KsError RegisterCallback(
     AppCallback callback,
     PVOID context
);

參數

callback：每一周期將呼叫的回呼函式指標。請見 AppCallback 類型。

context：若需要，傳遞給回呼函式的指標。

回傳值

如果此函式執行成功，會回傳 errNoError，否則會傳回錯誤碼。如需更多有關錯誤碼的資訊，請參閱 KsError 清單。

備註

• 註冊回呼為非必要，可在應用程式使用自己的週期執行緒。
• 因 RegisterCallback 之即時功能性，其僅可在 RT 介面使用，在其他介面呼叫此函式將會出現 errWrongEnvironment 錯誤。

可用的 EtherCAT 狀態

ecatOP

範例

/*
*    Assume that there is already a callback function in namespace userApp:
*    namespace userApp
*    {
*        int callBack(PVOID Context)
         {
*            return 0;
*        }
*    }
*
*    You can pass the function pointer as an argument:
*/
AppCallback callBack = userApp::callBack;
nRet = RegisterCallback(callBack, NULL);

/*
*    Or you can decay a lambda function to a function pointer (C++11):
*/
nRet = RegisterCallback([](PVOID Context){ return 0; }, NULL);

使用需求

參見

Create

RegisterMailboxCallback

Start